Authorizations API
Technical Notes
Endpoints
/omaha/authorizations.get:
Note: pass "any" for paramater value authorizationType to see all authorization types.
/omaha/authorization-result.get:
Cash Advance Note
- This API may be required in order to determine the approval or decline of a cash advance depending on how a merchant is set up.
- To run /omaha/authorization-result.get, this will require leveraging the āreferenceNumberā from /omaha/transactions/cash-advance, which determines whether the authorization was processed outside of Co-op (indicated with a value greater than zero).
- Use ARD_REF_NMBR returned as the value for the referenceNumber parameter.
- In the Beta environment, the cash advance process may cause this endpoint to produce inaccurate and/or inconsistent results. In production, authorizations are sent to MasterCard or Visa.
- However, the test environment is not set up this way.
Refer to the Authorization Reason Codes below under Resources for a complete list of valid codes for the parameter - AR_H_ADD_ACTION_IND.
Refer to Match data table below for field cross ref.
/omaha/authorizations/adjustment:
Note: pay attention to amount parameter as it does not take in decimal. Amount with decimal should be multipled by 100 to remove decimal. Example: $150.00 = 15000
/omaha/authorizations/cash-advance:
Note: pay attention to amount parameter as it does not take in decimal. Amount with decimal should be multipled by 100 to remove decimal. Example: $150.00 = 15000
/omaha/outstanding-authorizations.get:
Note: will return all outstanding authorizations.
Auth/Transaction Playback
āDe-dupeā authorizations and transactions using the Auth Approval Code and the Transaction Auth Number.
Logic is this: When looping through the Authorizations View, if there is an Auth Approval Code that matches a Transaction Auth Number, the authorization will be skipped and not read to the cardholder.
All Transactions will be read to the cardholder with the exception of items with left(ReferenceNumber, 1) = āFā, tran code = 990 and authamt = $0
/connex/authorization-override.get:
This endpoint may require multiple calls depending on how large your page size is.
To view Limit types and meanings, please refer to the Limit Type IDs below.
Note: please validate with your Financial Institution's settings to know which limits are available to your financial institution.
/connex/authorization-override POST:
To view Limit types and meanings, please refer to the Limit Type IDs below.
If beginDate and endDate are not set it will be overriden indefinetly.
Note: please validate with your Financial Institution's settings to know which limits are available to your financial institution.
/connex/authorization-override PUT:
To view Limit types and meanings, please refer to the Limit Type IDs below.
If beginDate and endDate are not set it will be overriden indefinetly.
Note: please validate with your Financial Institution's settings to know which limits are available to your financial institution.
/connex/authorization-override.delete:
Note: please validate with your Financial Institution's settings to know which limits are available to your financial institution.
/connex/authorization-accountholds.get:
This endpoint may require multiple calls depending on how large your page size is.
/connex/authorization-accountholds.delete:
Note: please validate with your Financial Institution's settings to know which limits are available to your financial institution.
/connex/authorization-card-accountholds.get:
This endpoint may require multiple calls depending on how large your page size is.
/connex/authorization-limitholds.delete:
Note: please validate with your Financial Institution's settings to know which limits are available to your financial institution.
/connex/authorization-limitholds.get:
This endpoint may require multiple calls depending on how large your page size is.
Note: please validate with your Financial Institution's settings to know which limits are available to your financial institution.
Resources
Limit Type IDs
This table contains a list of Limit Types IDs
Description | Limit Type Name |
---|---|
Withdrawals | WDR020 WDR021 |
Online Withdrawals | WDR040 WDR041 |
Purchases | PUR020 PUR021 |
Purchases (VC/MM) | PUR030 PUR031 |
Purchases VM Shared Usage | PUR032 PUR033 |
Online Purchases | PUR040 PUR041 |
Online Purchases (VC/MM) | PUR050 PUR051 |
Online Purch VM Shared Usage | PUR052 PUR053 |
Purchases | PPA020 PPA021 |
Total Purchases VM/Regional | TPU020 TPU021 |
Online Total Purchases VM/Regional | TPU040 TPU041 |
Total Debit Activity | TDB020 TDB021 |
Online Total Debit Activity | TDB040 TDB041 |
Balance Inquiries | BAL020 BAL021 |
Online Balance Inquiries | BAL040 BAL041 |
Deposits/Payments | DEP020 DEP021 |
Online Deposits/Payments | DEP040 DEP041 |
Check Deposits | DEP060 DEP061 |
Online Check Deposits | DEP080 DEP081 |
Available Deposits | AVD020 AVD021 |
Online Available Deposits | AVD040 AVD041 |
Available Payments | AVP020 AVP021 |
Online Available Payments | AVP040 AVP041 |
Visa Funds Transfer | AFT020 AFT021 |
Online Visa Funds Transfer | AFT040 AFT041 |
Available Transfers | AVT020 AVT021 |
Transfers | TFR020 TFR021 |
Online Transfers | TFR040 TFR041 |
Purchase Returns | PRE020 PRE021 |
Online Purchase Returns | PRE040 PRE041 |
Cash Back | CSB020 CSB021 |
Online Cash Back | CSB040 CSB041 |
Unlimited Availability | UAV020 UAV021 |
Payments from 3rd Party | PAY020/040 PFT020/040 |
Authorization Reason Codes
The Authorization Reason Codes table references a complete list of valid codes for the parameter -
AR_-H-_ADD-_ACTION-_IND in the endpoint - /omaha/authorization-result.get.
Code | Authorization Reason |
---|---|
00 | No additional action specified |
01 | Authorization by expansion |
02 | Get new address |
03 | Get positive identification |
04 | Call me |
05 | Pick up card |
06 | Invalid card number |
07 | Invalid merchant number |
08 | Invalid amount |
09 | Merchant not on file |
0A | Non-FDR cardholder and merchant |
0B | Processor record not found |
0C | Invalid merchant assessment code |
0D | Closed merchant |
0E | Invalid expiration date |
0F | Invalid mail order flag |
10 | Over single authorization limit |
11 | Over cash advance single limit |
12 | Under cash advance minimum |
13 | Overlimit |
14 | File error |
15 | Cardholder record not found |
16 | Excessive transactions |
17 | Over cash advance total limit |
18 | Use external status as reason |
19 | Use internal status as reason |
1A | Invalid ETC (Electronic Ticket Capture) transaction type |
1B | Not ETC merchant |
1C | Ask for transaction type |
1D | Only ETC transaction type 4 valid |
1E | Cardholder invalid for merchant |
1F | Attala box down |
20 | Aborted call |
21 | VIP status |
22 | Transmit name BASE/INAS |
23 | Center closed |
24 | Card number on negative file |
25 | Communication line down |
26 | Bad read CVV |
27 | Bad stripe CVV |
28 | COV - MCC/CTY/ZIP |
29 | Invalid PIN point phone number |
2A | Merchant on wrong system |
2B | Cardholder on wrong system |
2C | Over daily spending limit |
2D | BASE response - below minimum |
2E | Invalid PIN number |
2F | PIN service unavailable |
30 | Excessive PIN transactions |
31 | BASE I System error |
32 | Card use exceeded maximum |
33 | Rejected PIN |
34 | Authorization approval of partial amount |
35 | Rejected PIN for invalid block format |
36 | Rejected for invalid encrypted PIN |
37 | INAS - invalid ATM terminal identification |
38 | Invalid transaction type |
39 | Function unavailable |
3A | Referral |
3B | Have merchant do CALL ME |
3C | Display optional data only |
3D | ETC files disabled |
3E | Manual decline |
3F | Exceeds commercial card spending limit |
40 | Commercial card - company overlimit |
41 | Diversion account delinquent |
42 | INAS manual reject - Invalid PIN |
43 | Diversion account overlimit |
44 | Diversion account delinquent and overlimit |
45 | Diversion account exceeds spending limit |
46 | Relationship ProcessingĀ® service - overlimit/family level |
47 | Relationship ProcessingĀ® service - family not active |
48 | Diversion account |
49 | Invalid CVV2/CVC2 value entered |
4A | Name mismatch track one |
4B | Verify order |
4C | Payment reversal does not match to payment |
4D | ETC Plus credit item gap > 200 |
4E | Invalid loan officer identification |
4F | Duplicate authorization |
50 | Not signed on |
51 | Authorization System malfunction |
52 | Invalid prefix for DES PIN |
53 | Message format problem |
54 | Decline reason set |
55 | Service not available |
56 | Over merchandise total limit |
57 | Display name meets counterfeit parameters |
58 | On Combined Warning Bulletin flag was set |
59 | Invalid SE number - AMEX |
5A | New/reissue declined |
5B | New/reissue get positive identification |
5C | Issuer center down |
5D | Invalid department code |
5E | ETC retry code |
5F | Decline āYā authorization flag |
60 | No matching detail ETC void/reversal |
61 | Lost card |
62 | Stolen card |
63 | Stop payment on check |
64 | Unable to authorize |
65 | Vendor not on company card vendor list |
66 | ETC - invalid batch sequence number |
67 | ETC - batch has reached item limit |
68 | Over JCB limit-transfer to Jesta network |
69 | Invalid service restriction code |
6A | Invalid CVV value |
6B | Rejected CVV |
6C | Invalid ticket terms |
6D | Consecutive authorization over PCF cash limit |
6E | Authorization prior to valid date |
6F | Issuer not permitted ATM inquiries |
70 | COV - HIGH/LOW |
71 | No match on preapproved authorization |
72 | Excessive transactions, get positive identification |
73 | Excessive PIN attempts, get positive identification |
74 | Card verification declined |
75 | Card verification get positive identification |
76 | Do not honor |
77 | Insufficient funds |
78 | Account closed |
79 | Card statused severity 1 |
7A | Card statused severity 4 |
7B | Card statused severity 4 |
7C | Account statused |
7D | Less than minimum amount required |
7E | Card statused severity 2 |
7F | Card statused severity 5 |
80 | Re-enter transaction |
81 | File temporarily unavailable |
82 | Card expired on Master File |
83 | Mismatched expiration date |
84 | Decline for NRI (not received as issued) |
85 | NRI get positive identification |
86 | Decline counterfeit |
87 | Counterfeit get positive identification |
88 | Decline kiting |
89 | Kiting get positive identification |
8A | Decline lost/stolen |
8B | Lost/stolen get positive identification |
8C | Invalid item count |
8D | Invalid type change |
8E | Always Refer Flag set |
8F | Chip card authentication failure |
90 | Invalid fleet ID |
91 | Invalid fleet driver ID |
92 | Invalid fleet vehicle ID |
93 | Force standin at Association (Visa/MC) |
94 | Rejected 3D secure CAVV value |
95 | Invalid 3D secure CAVV value |
96 | Invalid PI external status |
97 | PI not on file |
98 | Ticket terms not active |
99 | Invalid ticket terms amount |
9A | Invalid MC UCAF value |
9B | No match found on āQā Request |
9C | Declined stop recurring payment |
9D | Invalid claim number |
9E | Reserved for restricted use |
9F | Reserved for restricted use |
A0 | Reserved for restricted use |
A1 | Reserved for restricted use |
A2 | Reserved for restricted use |
A3 | Client-defined decline reason code |
A4 | Reserved for healthcare processors |
A5 | Excessive transactions - PI |
A6 | Account day hour restricted |
A7 | ID day hour restricted |
A8 | Reserved for healthcare processors |
A9 | Reserved for healthcare processors |
AA | Chip record not found |
AB | Invalid ARQC |
AC | Check not activated |
AD | Real time decisioning decline |
AE | Reserved for healthcare processors |
AF | Commercial card super company overlimit |
B0 | Consumer control decline |
B1 | Commercial - TAN (Transaction Account Number) amount doesnāt match |
B2 | Commercial - TAN (Transaction Account Number) out of date range |
B3 | Surcharge not allowed on debit |
B4 | Prepaid non-reloadable cash back |
Decline Reason Codes
Code | Text | Description |
---|---|---|
00 | NO REASON SPEC | No reason specified - the authorization was approved and a response code was set, or the authorization was declined and a decline reason code was not found in the table of the reason codes |
01 | AUTH PROHIBITED | Authorization prohibited - customerās external status is A |
02 | BANKRUPT ACCOUNT | Bankrupt account - customerās external status is B |
03 | CLOSED ACCOUNT | Closed account - customerās external status is C |
04 | DELINQUENT ACC | Delinquent account - customerās internal status is D |
05 | REVOKED CARD | Revoked card - customerās external status is E |
06 | FROZEN ACCOUNT | Frozen account - customerās external status is F |
07 | INTEREST PROHIB | Interest prohibited - customerās external status is I |
08 | LOST CARD | Lost card - customerās external status is L |
09 | OVERLIMIT | Overlimit - customerās internal status is O, or the available credit is less than the amount of the authorization. The corporate account available credit and the overlimit tables are checked if appropriate. |
10 | STOLEN CARD | Stolen card - customerās external status is U |
11 | DELINQ AND OV LIM | Delinquent and overlimit - customerās internal status is X |
12 | CHARGED OFF ACC | Charged off account - customerās external status is Z |
13 | OVER ADV SING LIM | Over cash advance single limit - the amount requested for cash advance authorization is over the limit for a single cash advance authorization |
14 | OVER ADV TOT LIM | Over cash advance total limit - the requested cash advance authorization, added to outstanding authorizations, exceeds the total cash advance limit |
15 | OVER SINGLE LIMIT | Over single limit - the amount requested for a merchandise authorization is over the limit for a single merchandise authorization |
16 | EXCESSIVE AUTHS | Excessive authorizations - the number of authorizations exceeds the number allowed If the merchant calls into the voice authorization center, the authorization is approved and transferred to security to process the hot call. Positive identification is requested. |
17 | UNDER ADVANCE MIN | Under cash advance minimum ā the authorization request was for an amount less than the minimum cash advance |
18 | AUTH DECLINED | Reserved for restricted use |
19 | P TO P DECLINED | Person-to-person payment authorization declined - the authorization request for a MasterCardĀ® person-to-person payment transaction was declined |
20 | BAD READ CVV | Bad read Card Verification Value ā the authorization failed track 2 data verification on a swiped card because data was not read correctly |
21 | BAD STRIPE CVV | Bad stripe Card Verification Value ā the authorization failed track 2 data verification on a swiped card |
22 | COV - MCC/CTY/ZIP | Commercial card authorization override parameters - merchant category code/country code/ZIP code - an authorization has failed either the commercial card authorization override merchant category code, country code, or ZIP code |
23 | INV PINPT PHONE# | Invalid PINPoint telephone number. |
24 | MRCH ON WRONG SYS | Merchant on wrong system. |
25 | CHD ON WRONG SYS | Cardholder on wrong system |
26 | OVER DLY SPND LMT | Over daily spending limit - the requested authorization, plus the amount of the approved cash and merchandise authorizations, exceeds the total daily spending limit. |
27 | AUTH DEC-EXC ACT | Authorization declined-excess activity -MasterCard response for excessive use |
28 | 3D SECURE REJECTD | 3-D Secure rejected - 3-D Secure authorization was rejected because the authorization requirements were not met |
29 | AUTH DEC-SYS ERR | Authorization declined-System error - communication line is disabled |
30 | CRD INVL FOR MRCH | Card invalid for merchant - card could not be used at the requested merchant. This code is used primarily for merchant chain code edits and private label. |
31 | ACC ON NEG FILE | Account on negative file - the account was found on the negative file for OSCAS accounts or for merchant stand-ins. |
32 | AUTH DEC-EXP CD | Authorization declined-expired card ā the expiration date on the card is earlier than the current month and year |
33 | AUTH REF TO ISS | Authorization referred to issuer ā invalid terminal identification, or terminal transaction with a code 10, or line down |
34 | INVALID ID NUMBER | Invalid identification number ā Commercial card fleet identification number was invalid |
35 | INVALD DRIVER NUM | Invalid driver number - Commercial card fleet driver number was invalid |
36 | INVALD VEHICL NUM | Invalid vehicle number - Commercial card fleet vehicle number was invalid |
37 | EXCDS SPENDING LM | Exceeds spending limit - Commercial card declined for exceeding spending limits |
38 | COMPANY OVERLIMIT | Company overlimit - Commercial card company credit limit exceeded |
39 | FAMILY CARD OVLMT | Family card overlimit ā Relationship ProcessingĀ® account is overlimit |
40 | INAS-INVALID PIN | INAS-invalid PIN - MasterCard |
41 | DELINQ ACC DIV | Delinquent account diversion ā Commercial card diversion account is delinquent |
42 | FAMILY CARD INVAL | Family card invalid - Relationship ProcessingĀ® account is not valid or is statused |
43 | OVERLIMIT DIV | Overlimit diversion - Commercial card diversion account is overlimit |
44 | DELINQ AND OV DIV | Delinquent and overlimit diversion - Commercial card diversion account is delinquent and overlimit 45 |
45 | EXCDS SPEND DIV | Exceeds spending limit diversion ā Commercial card diversion account has exceeded spending limits |
46 | ALWY REFR CD SET | Always refer code set - always refer flag has been set on the account |
47 | OVERLIMIT PAY FLT | Overlimit payment float - assigned by batch payment float process |
48 | EXT STAT DIV ACCT | External status diversion account - Commercial card diversion account has an external status |
49 | INVALID CVC2/CVV2 | Invalid Card Validation Code 2/Card Verification Value 2 - authorization request contained an invalid CVC2/CVV2 |
50 | TRK1 NAME MISMATC | Track 1 name mismatch - customer name in track 1 of authorization does not match name on the cardholder account record |
51 | VERIFY ORDER | Reserved for restricted use |
52 | CHP ATHNTCTN FAIL | Chip authentication failed - Visa performed chip authentication and it failed |
53 | 3D SECURE INVALID 3-D | Secure invalid - 3-D Secure authorization declined due to CAVV validation failure |
54 | UCAF DECLINED | Universal Cardholder Authentication Field declined - authorization request was declined due to UCAF validation failure |
55 | DECLINED STOP REC | Declined stop recurring payment |
56 | CLAIM VALID DECL | Claim validation decline |
57 | INVALID STATUS | Invalid status |
58 | PI NOT FOUND | Presentation instrument not found ā the customerās presentation instrument cannot be located in the system, and the authorization is rejected |
59 | PIN # INVALID | PIN number invalid - the entered PIN is invalid |
60 | PIN SERV UNAVLBL | PIN service unavailable - the PIN service was unavailable |
61 | EXC PIN ATTEMPTS | Excessive PIN attempts - the number of invalid PIN attempts is greater than the number of PIN attempts allowed in a day |
62 | PI AUTH PROHIBITD | Presentation instrument authorization prohibited - presentation instrument external status is A |
63 | CLOSED - PI | Closed account presentation instrument -presentation instrument external status is C |
64 | LOST - PI | Lost card presentation instrument -presentation instrument external status is L |
65 | STOLEN - PI | Stolen card presentation instrument -presentation instrument external status is U |
66 | ERROR | Error - the Card Verification Value (CVV) was invalid, or the encryption was invalid |
67 | OVER MRCH TOT LMT | Over merchandise total limit - the requested merchandise authorization, added to outstanding authorizations, exceeds the total merchandise limit |
68 | ACCOUNT ON CWB | Account on Combined Warning Bulletin ā the customerās account is flagged as being on the warning bulletin |
69 | SERVICE NOT AVAIL | Service not available - merchant response for service not available |
70 | TRANS NOT ALLOWED | Transaction not allowed - right-time payment reversal does not match a previous right-time payment |
71 | SYSTEM DOWN | System down - reserved for NYCE debit card transactions only |
72 | PARTIAL APPROVAL | A part of the requested authorization amount has been approved |
73 | ACCT NOT ON FILE | Account not on file - the customerās account cannot be located on the System, and the authorization is rejected |
74 | INVALID ACCT | Invalid account - account number was invalid |
75 | NEW/REISSUE | New/reissue - the plastic is new or reissued for the customer and this is the first time used; positive identification is requested |
76 | ISS. CENTER DOWN | Issuer center down - communication lines unavailable from issuing system |
77 | AUTH FLAG = Y | Authorization flag is a Y - the authorization flag on the customerās account is set to Y. An authorization for this account will always be declined. |
78 | PICK UP CARD | Pick up card - OSCAS processing response was to pick up the card. |
79 **** | STOP PAYMENT | Stop payment on check cash advances ā an authorization for a check cash advance can be stopped. This is the error when the authorization is processed. |
80 | UNABLE TO AUTH | Unable to authorize - the authorization is for a cash advance and the customerās account cannot be used for this type of authorization |
81 | CVL-INVALID MRCH | Commercial Card Vendor List-invalid merchant - a commercial card customer attempted to use the plastic at a merchant that was not set up on the Commercial Card Vendor List |
82 | Not used | |
83 | INV SERVICE CODE | Invalid service restriction code - cardās track 2 data contains a service code. This service code is checked against a table and if there is not a match, the authorization is rejected. |
84 | INVALID CVV/CVC | Invalid Card Verification Value/Card Validation Code - the CVV/CVC was invalid during PIN validation. |
85 | REJECTED CVV/CVC | Rejected Card Verification Value/Card Validation Code - the CVV/CVC was invalid |
86 | AUTH PRIO TO VDAT | Authorization prior to valid date - the plastic was used prior to the valid start date for that plastic |
87 | ATM INQ RESTRICTD | ATM inquiry restricted - authorization request was an ATM inquiry, which was not allowed for this customer |
88 | COV - HIGH/LOW | Commercial card authorization override parameters - authorization request has failed either the low amount or high amount check |
89 | NO MATCH-PREAPPRV | No match-preapproved authorization ā the customer number does not match the merchant account number on a batch authorization originated by a manual authorization |
90 | EXCESS TRAN POSID | Excessive transactions get positive identification - the customer had too many authorizations. The authorization was declined and a positive identification was requested. |
91 | EXCESS PIN POS ID | Excessive PIN attempts get positive identification - the customer had too many PIN attempts. The authorization was declined and a positive identification was requested. |
92 | CARD VERIFY DECLN | Card verify decline - positive identification cannot be |
93 | INVALID TCKT TERM | Invalid ticket terms |
94 | CARD EXPD ON MAST | Card expired on the Cardholder Master File -the expiration date stored on the cardholder account record is earlier than the current date |
95 | NRI SUSPECT FRAUD | Not received as issued suspect fraud ā the authorization request was suspected of being fraudulent |
96 | COUNTERFT SUSPECT | Counterfeit suspect fraud - the authorization request was suspected of being fraudulent based on a counterfeit strategy |
97 | KITING SUSPECT | Kiting suspect fraud - the authorization request was suspected of being fraudulent based on a kiting strategy |
98 | LOST/STLN SUSPECT | Lost/stolen suspect - the authorization was suspected of being fraudulent since a lost record was stored for the customer |
99 | MISMATCH EXP DATE | Mismatch expiration date - the expiration date from the track data does not match the expiration date on the cardholder account record on a swiped card |
100 | PBM NOT MATCHED | Reserved for healthcare processors |
101 | EXCESS TRANS - PI | Excessive authorizations at the card level ā the number of authorizations exceeds the number allowed |
102 | ACCT DAYHOUR RSTR | Reserved for restricted use |
103 | ID DAY HOUR RSTR | Reserved for restricted use |
104 | COPAY NO MATCH | Reserved for healthcare processors |
105 | HC PLAN NOT FOUND | Reserved for healthcare processors |
106 | CHIP RC NOT FOUND | Chip record not found |
107 | INVALID ARQC | Invalid Authorization Request Cryptogram (ARQC) - the EMV validation data presented does not match the calculated value |
108 | CARD STATUSED | EMV card or APP has been blocked |
109 | CHECK ACTIVATION | Convenience or balance consolidation check was declined because check activation is required |
110 | ASSOC RTD DECLINE | Association RTD decline - the authorization was declined by the Visa Real Time Decision (RTD) Service with an advice response code 59, suspected fraudulent transaction |
111 | NON-IIAS TRANSACTION | Reserved for healthcare processors |
112 | SUPER CMPY OVERLM | Super company overlimit - Commercial card super company credit limit exceeded |
113 | CONSUMER CONTROL | Consumer Control - Edit within consumer control set the decline |
114 | NOT EXACT MATCH | Commercial card - Transaction amount did not match with Transaction Account Number (TAN) amount |
115 | NOT IN DATE RANGE | Commercial card - Transaction is not within allowed TAN dates |
117 | CASH ON NON-RELOADABLE | Cash back on non-loadable prepaid card ā The System automatically declined the cash back amount on a Visa or MasterCard non-reloadable prepaid card |
121 | TOKEN MAP FAIL NO PAN | PAN mapping record cannot be found for the token |
122 | TOKEN MAP FAIL ASSOCIATION ISSUE | PAN mapping cannot be performed for the token due, for example, to technical issues |
123 | TOKEN SUSPENDED/DEACTIVATED | Token suspended |
124 | ADDITIONAL AUTHEN | Token provision request requires additional authentication |
125 | HI RISK ADDL ATHN | Token provision request is considered high risk, and requires additional authentication |
126 | RECOMM ADDL ATHN | Token provision request and additional authentication is recommended |
172 | EXTERNAL STATUS | PIN change via PIN Now; card has an external status |
179 | SURCHARGE NOT ALLOWED | Attempt to assess a surcharge on a debit or prepaid card |
193 | OUTSTANDING CHANG | PIN change via PIN Now; more than one PIN change attempted (only one per day allowed) |
201 | Not used | |
202 | Not used |
Match Data
Match Data is the data used to associate the authorized item to the settled item. The following defined match data types include POS Pre-Authorization, Debit Master Card, Visa Check with Transaction Identifiers, Visa Check without Transaction Identifiers.
POS Pre-Authorization
- Positions 1-12: Last 12 digits of the card number performing the transaction that placed the hold.
- Positions 13-27: The Terminal Reference is the number from the terminal used in the transaction.
- Position 28: P (standard POS pre-authorization)
- Positions 29-30: Blank Fill
- Positions 31-36: The authorization number for the hold transaction. Use the AP or online host assigned authorization number.
Debit MasterCardĀ®
- Positions 1-12: Last 12 digits of the card number performing the transaction that placed the hold.
- Positions 13-27: Terminal Reference is the number from the terminal used in the transaction.
- Position 28: M (Debit MasterCardĀ® transaction)
- Positions 29-30: Terminal Day is the 2-digit day of the month when the original transaction occurred.
- Positions 31-36: The authorization number for the hold transaction. Use the AP or online host assigned authorization number.
Visa Checkā¢ with Transaction Identifiers
- Positions 1-12: Last 12 digits of the card number performing the transaction that placed the hold.
- Positions 13-27: The VisaĀ® Transaction Identifier for this transaction.
- Position 28: V (Visa Checkā¢ transaction)
- Positions 29-30: Terminal Day is the 2-digit day of the month when the original transaction occurred.
- Positions 31-36: The authorization number for the hold transaction. Use the AP or online host assigned authorization number.
Visa Checkā¢ without Transaction Identifiers
- Positions 1-2: Last 12 digits of the card number performing the transaction that placed the hold.
- Positions 13-20: The Terminal Reference number from the terminal used in the transaction.
- Positions 21-27: Blank or Space fill
- Position 28: V (Visa Check transaction)
- Positions 29-30: Terminal Day is the 2-digit day of the month when the original transaction occurred.
- Positions 31-36: The authorization number for the hold transaction. Use the AP or online host assigned authorization number.